﻿<%@ Control Language="C#" Inherits="System.Web.Mvc.ViewUserControl<dbPoll_Application.ViewModels.HelpViewModel>" %>
    
 <h2>Managing Polls</h2>
 <ol>
    <li><a href="#tracking">Tracking Poll Results</a></li>
    
    <li><a href="#participantedit">Building a Participant List for Tracking</a></li>
        <ul>
            <li><a href="#webparticipant">Adding a Web Participant to a Poll</a></li>
            <li><a href="#keypadparticipant">Adding a Keypad Participant to a Poll</a></li>
            <li><a href="#participantdelete">Deleting a Participant from a Poll</a></li>
        </ul>
    
    <li><a href="customizeparticipantlist">Customising a Participant List</a></li>
        <ul>
            <li><a href="#participantlistindividual">Customing a Participant List for Tracking Individuals in a Poll</a></li>
            <li><a href="#participantlistgroup">Customising a Participant List for Tracking Groups in a Poll</a></li>
            <li><a href="#votingweight">Adding a Voting Weight Field to a Participant List</a></li>
        </ul>
     
     <li><a href="#managingentityhierarchy">Managing Entity Hierarchy</a></li>
     <li><a href="#pollmodifying">Modifying a Poll</a></li>
        <ul>
            <li><a href="#geographiclocation">Modifying a Poll's Geographic Location</a></li>
            <li><a href="#fontsettings">Modifying a Poll's Font Settings</a></li>
            <li><a href="#resultschart">Modifying a Poll's Results Chart</a></li>
            <li><a href="#interactiveobjects">Adding Interactive Objects to a Poll</a></li>
        </ul>   
     <li><a href="#aftercompletion">Editing Selected Poll Data After Poll Completion</a></li>
        <ul>
            <li><a href="#deleteaftercompletion">Deleting a Poll Question</a></li>
            <li><a href="#editaftercompletion">Editing a Poll Question</a></li>
        </ul>
     
        
 </ol>
 
 <p id="tracking"><u>Tracking Poll Results</u>
 
 <p>
 To elect to track the results of a poll 
 <ol>
     <li>Click on the <strong>Polls</strong> tab in the top right-hand corner of the screen</li>
     <li>Locate the poll in the generated table of polls and click on the poll name</li>
     <li>In the Poll Details editing screen, tick the <em>Tracked</em> checkbox to track poll results</li>
     <li>Optionally, tick the <em>Participant List</em> checkbox to use a Participant List for tracking. If a Participant List is not used, generic web users will be prompted for their first and last name when responding to a poll</li>
     <li>Click <strong>Save Poll</strong></li>
 </ol>
 </p>
 
 </p>
 
 <p id="participantedit"><u>Building a Participant List for Tracking</u>

    <p id="webparticipant">To add a web participant to a poll
    <ol>
        <li>Click on the <strong>Polls</strong> tab in the top right-hand corner of the screen</li>
        <li>Locate the poll in the generated table of polls and click on the poll name</li>
        <li>In the Poll Details editing screen, click on the count of participants to modify the poll's Participant List</li>
        <li>At the bottom of the page, click <strong>Add Participant</strong></li>
        <li>5. In the following screen, enter the email address of the web user you wish to add and click <strong>Add Web User</strong></li>
        <ul>
            <li>If there is no poll user in the system with this email address, a message box will prompt you to add the user to the system, or cancel modification of the Participant List</li>
        </ul>
    </ol>
    </p>
     
    <p id="keypadparticipant">To add a keypad participant to a poll
    <ol>
        <li>Click on the <strong>Polls</strong> tab in the top right-hand corner of the screen</li>
        <li>Locate the poll in the generated table of polls and click on the poll name</li>
        <li>In the Poll Details editing screen, click on the count of participants to modify the poll's Participant List</li>
        <li>At the bottom of the page, click <strong>Add Participant</strong></li>
        <ul>
            <li>To add a single keypad participant manually to the Participant List, enter the participant's Device ID into the relevant textfield and click <strong>Add Keypad User</strong></li>
            <li>To add multiple keypad participants to the poll, press any key on each of the keypads to have them registered by the system and automatically added to the poll's Participant List</li>
        </ul>
    </ol>
    </p>
    
    <p id="participantdelete">To delete a participant from a poll
    <ol>
        <li>Click on the <strong>Polls</strong> tab in the top right-hand corner of the screen</li>
        <li>Locate the poll in the generated table of polls and click on the poll name</li>
        <li>In the Poll Details editing screen, click on the count of participants to modify the poll's Participant List</li>
        <li>Locate the participant in the table and click <strong>Delete</strong></li>
    </ol>
    </p>
    
 </p>
 
 <p id="customizeparticipantlist"><u>Customising a Participant List</u>
    
    <p id="participantlistindividual">To customise a participant list for tracking individuals in a poll
    <ol>
        <li>Click on the <strong>Polls</strong> tab in the top right-hand corner of the screen</li>
        <li>Locate the poll in the generated table of polls and click on the poll name</li>
        <li>In the Poll Details editing screen, tick the <em>Participant List</em> checkbox if it is unchecked</li>
        <li>Click on <strong>[edit]</strong></li>
        
        <p align="center"><img src="../../Resources/Help/PollMaster-ParticipantList.png" width="445" height="170" /></p>    
        
        <li>The system will display a table of the Participant List for this poll</li>
        <li>To track results across individuals, check the <em>Individual</em> radio button at the top of the screen and select <strong>Submit Query</strong></li>
        <li>Customise the individual participant list either by:</li>
        <ul>
            <li>Using a participant list template, by selecting the template from the dropdown box of templates to automatically add the demographic fields from that template into the list. In order to customise the template, simply modify the list as specified below</li>
            <li>Creating custom demographic fields by clicking on the <strong>Edit List</strong> button</li>
            <ul>
                <li>To add a custom demographic field to the Participant List, use the <em>Add Field</em> textbox at the top of the screen and click <strong>Add</strong></li>
                <li>To delete a field from the Participant List, select <strong>Delete</strong> beneath the relevant field </li>
                <li>To modify values entered for fields in the Participant List or update poll user's names or Device IDs, modify the relevant values in the textfields provided and select <strong>Save</strong> at the bottom of the table</li>
                <li>To associate a poll user with an entity, select the entity from the Entity combo box and click <strong>Save</strong></li>
            </ul>
        </ul>
        
    </ol>
    </p>
    
    <p id="participantlistgroup">To customise a participant list for tracking groups in a poll
    <ol>
        <li>Click on the <strong>Polls</strong> tab in the top right-hand corner of the screen</li>
        <li>Locate the poll in the generated table of polls and click on the poll name</li>
        <li>In the Poll Details editing screen, tick the <em>Participant List</em> checkbox if it is unchecked</li>
        <li>Click on <strong>[edit]</strong></li>
        <li>The system will display a table of the Participant List for this poll</li>
        <li>To track results across groups, check the <em>Group</em> radio button at the top of the screen and select <strong>Submit Query</strong></li>
        <ul>
            <li>To add a group for tracking on the Participant List, give the group a name in the <em>Add Group</em> textbox and click <strong>Add</strong></li>
            <li>To remove a group from tracking, locate the group in the Participant List and click <strong>Delete</strong></li>
            <li>To add participants to a created group, click on the group in the Participant List to view members of the group and click <strong>Add Participants</strong></li>
            <ol>
            
                    <p align="center"><img src="../../Resources/Help/PollMaster-AddParticipants.png" width="500" height="150"/></p>    
            
                <li>In the following screen, tick the checkbox of each Device ID/Username of the participants you wish to add to the group</li>
                <li>Click <strong>Add Participants</strong></li>
            </ol>
            <li>To remove participants from a created group, click on the group in the Participant List to view members of the group</li>
            <ol>
                <li>In the following screen, locate the Device ID/Username of the participant you wish to remove from the group</li>
                <li>Click <strong>Delete</strong></li>
            </ol>
        </ul>       
        <li>Customise the individual participant list either by:</li>
        <ul>
            <li>Using a participant list template, by selecting the template from the dropdown box of templates to automatically add the demographic fields from that template into the list. In order to customise the template, simply modify the list as specified below</li>
            <li>Creating custom demographic fields by clicking on the <strong>Edit List</strong> button</li>
            <ul>
                <li>To add a custom demographic field to the Participant List, use the <em>Add Field</em> textbox at the top of the screen and click <strong>Add</strong></li>
                <li>To delete a field from the Participant List, select <strong>Delete</strong> beneath the relevant field </li>
                <li>To modify values entered for fields in the Participant List, modify the relevant values in the textfields provided and select <strong>Save</strong> at the bottom of the table</li>
                <li>To associate a group with an entity, select the entity from the Entity combo box and click <strong>Save</strong></li>
            </ul>
        </ul>
    </ol>
    </p>
    
    <p id="votingweight">To add a voting weight field to a participant list
    <ol>
        <li>Click on the <strong>Polls</strong> tab in the top right-hand corner of the screen</li>
        <li>Locate the poll in the generated table of polls and click on the poll name</li>
        <li>In the Poll Details editing screen, tick the <em>Participant List</em> checkbox if it is unchecked</li>
        <li>Click on <strong>[edit]</strong></li>
        <li>The system will display a table of the Participant List for this poll</li>
        <li>By default, all individuals have a voting weight of 1. To change this value, simply select the desired voting weight from the dropdown box (between 1 and 100) and click <strong>Save</strong></li>
    </ol>    
    </p>
 </p>  
 
 <p id="managingentityhierarchy"><u>Managing Entity Hierarchy</u>
    
    <p>To manage a poll's entity hierarchy
    <ol>
        <li>Click on the <strong>Polls</strong> tab in the top right-hand corner of the screen</li>
        <li>Locate the poll in the generated table of polls and click on the poll name</li>
        <li>Select <b>Manage Hierarchy</b> from the horizontal poll menu</li>
        <ul>
            <li>To add a new entity, right-click on the desired parent entity and select <strong>Create</strong></li>
            <li>To delete an existing entity, right-click on the entity and select <strong>Delete</strong></li>
            <li>To modify an existing entity, right-click on the entity and select <strong>Rename</strong></li>
            <li>To modify the existing hierarchy of entities, drag and drop entities around the graphical entity chart to rearrange the hierarchy </li>
        </ul>
    </ol>
    </p>
    
    </p>
 
 <p id="pollmodifying"><u>Modifying a Poll</u>
             
    <p id="geographiclocation">To modify a poll's geographical location
    <ol>
        <li>Click on the <strong>Polls</strong> tab in the top right-hand corner of the screen</li>
        <li>Locate the poll in the generated table of polls and click on the poll name</li>
        <li>On the right-hand side of the screen, change the poll location either by</li>
        <ul>
            <li>Clicking and dragging the location marker to the desired poll location on the map</li>
            <li>Manually, clicking <strong>Set Location</strong>, entering a latitude and longitude, and clicking <strong>OK</strong></li>
        </ul>
        <li>Click <strong>Save Poll</strong></li>
        <p align="center"><img src="../../Resources/Help/PollMaster-PollLocation.png" width="220" height="300" /></p>            
    </ol>
    </p>
     
    <p id="fontsettings">To change the font settings for poll
    <ol>
        <li>Click on the <strong>Polls</strong> tab in the top right-hand corner of the screen</li>
        <li>Locate the poll in the generated table of polls and click on the poll name</li>
        <ul>
            <li>To change the default font settings for future poll questions, make the desired modifications to the poll's font, font size, and font colour  under the relevant <em>Font Settings</em> heading
            <li>To change the font settings for an individual question in the poll, locate and click on the question in the generated <em>Questions</em> table, before making the desired modifications to the poll's font, font size, and font colour  under the relevant <em>Font Settings</em> heading</li>
        </ul>    
        <li>Click <strong>Save Poll</strong> or <strong>Save</strong></li>         
    </ol>
    </p>
        
    <p id="resultschart">To change the results chart for a poll
    <ol>
        <li>Click on the <strong>Polls</strong> tab in the top right-hand corner of the screen</li>
        <li>Locate the poll in the generated table of polls and click on the poll name</li>
        <ul>
            <li>To change the default display of graphical reports for future poll questions, make the desired modifications to the poll's results chart's type, value, and colours under the relevant <em>Results Chart</em> heading</li>
            <li>To change the display of graphical reports for an individual question in the poll, locate and click on the question in the generated <em>Questions</em> table, before making the desired modifications to the question's results chart's type, value, and colours under the relevant <em>Results Chart</em> heading</li>
        </ul>
        <li>Click <strong>Save Poll</strong> or <strong>Save</strong></li>         
    </ol>
    </p>
     
    <p id="interactiveobjects">To add Interactive Objects (Countdown Timer, Response Counter, Correct Answer Indicator, or Response Grid) to a poll
    <ol>
        <li>Click on the <strong>Polls</strong> tab in the top right-hand corner of the screen</li>
        <li>Locate the poll in the generated table of polls and click on the poll name</li>
        <ul>
            <li>To set default Interactive Objects for future poll questions, make the desired modifications to the poll under the relevant <em>Question Objects</em> heading
            <li>To set Interactive Objects for an individual question in the poll, locate and click on the question in the generated <em>Questions</em> table, before making the desired modifications to the question under the relevant <em>Question Objects</em> heading</li>
        </ul>
        <p align="center"><img src="../../Resources/Help/PollMaster-ResponseCounterandGrid.png"/></p> 
        <li>To add a Countdown Timer to a poll, tick the <em>Countdown Timer</em> checkbox and enter a numeric value in the textbox provided</li>
        <li>To add a Response Counter to a question, tick the <em>Response Counter</em> checkbox</li>
        <li>To add a Correct Answer Indicator to a question, tick the <em>Correct Answer Indicator</em> checkbox</li>
        <li>To add a Response Grid to a poll, tick the <em>Response Grid</em> checkbox and use the drop-down box to opt to display either participants' names or their keypad IDs</li>         
        <li>Click <strong>Save Poll</strong> or <strong>Save</strong></li>         
    </ol>
    </p>

 </p>
      
 <p id="aftercompletion"><u>Editing Selected Poll Data After Poll Completion</u>
    
    <p id="deleteaftercompletion">To delete a poll question after a poll is completed
    <ol>
        <li>Click on the <strong>Polls</strong> tab in the top right-hand corner of the screen</li>
        <li>Locate the poll in the generated table of polls and click on the poll name</li>
        <li>Locate the question in the generated table of poll questions and click <strong>Delete</strong></li>
    </ol> 
    </p>
      
    <p id="editaftercompletion">To edit a poll question after a poll is completed
    <ol>
        <li>Click on the <strong>Polls</strong> tab in the top right-hand corner of the screen</li>
        <li>Locate the poll in the generated table of polls and click on the poll name</li>
        <li>Locate the question in the generated table of poll questions and click on the question</li>
        <li>In the Question Editing screen, you will be able to</li>
        <ul>
            <li>Modify the point value of a question's answer by updating the appropriate text field</li>
            <li>Nominate a new correct answer for the question by ticking the <em>Correct</em> checkbox </li>
            <li>Change the standard question to a demographic question by clicking on the <strong>Convert</strong> button at the bottom of the screen</li>
            <li>Change the demographic question to a standard question by clicking on the <strong>Convert</strong> button at the bottom of the screen</li>
        </ul>
        <li>Once you have finished, click <strong>Save</strong> to save your changes</li>  
    </ol> 
    </p>
              
 </p>